SGPanelValidateInput(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Processing Your Panel's Events

SGPanelValidateInput
Sequence grabber components call your component's SGPanelValidateInput function in order to allow you to validate the contents of the user dialog box.
pascal ComponentResult SGPanelValidateInput
                                  (SeqGrabPanelComponent s,
                                    Boolean *ok);
s
Identifies the sequence grabber component's connection to your panel component.
ok
Contains a pointer to a Boolean value. You set this Boolean value to indicate whether the user's settings are acceptable. Set it to true if the settings are OK; otherwise, set it to false.

DESCRIPTION
A sequence grabber component calls your SGPanelValidateInput function in order to allow you to validate the settings chosen by the user. This is your opportunity to validate the settings in their entirety, including those for which you may not have received dialog events or mouse clicks. For example, if your panel component uses a TextEdit box, you should validate its contents at this time. Be sure to give the user some indication of what to do to fix the settings.
The sequence grabber calls this function when the user clicks the OK button. If the user clicks the Cancel button, the sequence grabber does not call this function.
You indicate whether the settings are acceptable by setting the Boolean value referred to by the ok parameter. If you set this Boolean value to false, the sequence grabber component ignores the OK button in the dialog box.

SEE ALSO
Your component can process mouse clicks with your SGPanelItem function, described on page 7-21. Your component can filter all dialog events with your SGPanelEvent function, described in the previous section.